Gemplus Smart Card Readers & Tools Installer - Version 3.13.0.0
Integrator Package
August, 2004


TABLE OF CONTENTS

  1. Readers Supported
  2. Tools Installed
  3. System Components Installed
  4. Pre-requisites
  5. Command Line Options
  6. SmartDiag Get Assistance Options
  7. Other Options
  8. Notes
  9. Troubleshooting
  10. Installing execution trace and Return code


1. The package supports the following Gemplus smart card readers

  Reader      Connector         OS supported

  GemPC400    PC-Card           95, 98, 98SE, ME, NT4,  2000, XP , Server 2003
  GemPC410    Serial            95, 98, 98SE, ME, NT4,  2000, XP , Server 2003
  GemPC413    Serial            95, 98, 98SE, ME, NT4,  2000, XP , Server 2003
  GemPCTwin   Serial/USB       95*, 98, 98SE, ME, NT4*, 2000, XP , Server 2003  
  GemPC430    USB                   98, 98SE, ME,       2000, XP , Server 2003
  GemPC433    USB                   98, 98SE, ME,       2000, XP , Server 2003
  GemPCKey    USB                   98, 98SE, ME,       2000, XP , Server 2003
  GemPCSerial Serial            95, 98, 98SE, ME, NT4,  2000, XP , Server 2003
  GemPCUSB    USB                   98, 98SE, ME,       2000, XP , Server 2003
  GemPCCard   PC-Card               98, 98SE, ME, NT4,  2000, XP , Server 2003


*GemPCTwin drivers are installed for serial port on Windows 95 and NT4.


2. Installed tools

  Tool         Main File        Use

  GetStarted   gemstrmw.exe     Completes installation of readers.
                                Manages Smart Card Resource Manager
                                for better support of PnP devices.

  SmartDiag    SmartDiag.exe    Diagnoses the smart card system.



3. System components installed

Under Windows 95, 98, 98SE, ME, and NT4, the operating system is
updated with the Microsoft Smart Card Base Components, other OS
support smart card natively.

MFC42.dll may also be updated on a number of systems.



4. Pre-requisites

Microsoft Internet Explorer 5.5 installs all the required system
files.



5. Command Line Options

setup.exe command line:

  /s Silent mode.
     For NT4 only, silent install is possible if a single reader is
     available, If more than a reader is available, /s is ignored.

  /s:<reader name>
     For a specific reader installation in silent mode. (only one at time)
     reader name list supported:  GemPC400, GemPC410, GemPC413, GemPC430,
     GemPC433, GemPCSerial, GemPCUSB, GemPCKey.

  /d=<"Yes" or "No">
     Display an icon in the Add/Remove Programs applet of the
     Control Pannel.  Preceeds the AddRemoveDisplay key of
     setup.ini.

  /p="<installation path>"
     Specifies an installation path.  Relative path are created in
     the Program Files folder.  Preceeds the InstallPath key of
     setup.ini.
  /g="<program group>"
     Specifies under which Start menu folder, the shortcuts will be
     created.  If this path contains a star '*', no shortcuts are
     created.
  /u
     Uninstalls.  The only other flag supported with /u is /s.
     If a reader name is specified after /s, it will be ignored.

WARNING:  Never call the Setup /u in the source directory !
The Host application should call the setup.exe locate in the
Installer directory where you what to uninstall the Smartcard reader tools.


Sample of silent Installation of GemPCSerial:
setup.exe /s:GemPCSerial


Sample of Un-Installation in silent mode:
Setup.exe /s /u


Sample of multiple argument:
setup.exe /s:GemPC410 /d="No" /p="C:\Program Files\Gemplus\ACME\" 
/g="C:\WINNT\Profiles\All Users\Start Menu\Programs\ACME\ACME tools"



6. SmartDiag Get Assistance Options

In case of problem, SmartDiag will propose the user to send a
SmartDiag report by e-mail to the technical support.  You can add
some registry entries so the e-mail is created for the attention
of the proper recipient.  You can also customize the subject and
the message body.  Note that user is invited to give more details
about the problem in the e-mail.  The user may also edit other
fields of the e-mail or even cancel it.

However, be careful.  SmartDiag may be used by different products
and the following registry values will be used each time SmartDiag
creates an e-mail.  The following string values are located in:
HKCU\Software\Gemplus\SmartDiag\GetAssistance.

  DefaultEmail
  The recipient address of the technical support for the generated
  e-mail.  If not specified the To field of the e-mail will be
  left empty.
 
  DefaultSubject
  The subject that will appear in the generated email.  If the key
  does not exist, the subject of the e-mail will be:
  "Smart Card Interface Problem"

  DefaultBodyTemplate
  The file name that contains the text to paste into the message
  body of the e-mail.  The path should be a full path.  If it is
  specified, the current application directory will be used.  If
  the registry key or the specified file does not exist, the
  default Technical Request Support Form will be used.

 

7. Other Options

The GetStarted.ini may be customized to fit your needs, 
please read them as they contain all the necessary info.

The GetStarted.ini file should be locate in the GetStarted 
directory to be effective at installation time.

If you wish to support only a selected set of the readers you may
simply delete the other readers' installation DLL along with its
folder from this kit.  Similarly, you can delete SmartDiag
installation DLL and its folder if you do not want SmartDiag to
be installed.

In the opposite, you can upgrade your kit with new readers simply
by adding the associated install DLL and folder. This is exactly
the same components than those used in the web package: see
www.gemplus.com and select Support.

Do not use old "readerinstallation dll" with this newer version 
3.1 of this product.



8. Notes

If the user have connected the reader before running the installer,
the user will need to cancel the New Hardware Found wizard.

On all OS except NT4, the installer will pre-install all the
above-mentioned readers automatically.  The installation will be
completed when you connect the reader or on the following boot.

On NT4, the user is required to select which reader needs to be
installed, unless if only one reader can be installed on this OS.

Uninstalling the reader tools will not remove the driver nor the
smart card base components.

Uninstallation exectuable, Be sure you run the Setup.exe in the 
installed directoty.  By default installation path is:
"C:\Program Files\Gemplus\ReaderTools\Installer"



9. Troubleshooting

Windows 95 and NT4 do not support USB devices.

Multi-reader installation is not supported on 95, 98, 98SE and ME.
That means that if you connect more than one reader under those OS
you may run into problems and possibly only one will be accessible
to application.

It is possible that the kit replaces a driver with an older
version.  If this occurs, please download the latest version and
re-run the reader installation.


If you run into other problems, run the SmartDiag tool included to
know exactly what it is and how to solve it.


The GemPCSerial and GemPCKey on Windows 98, 98SE and ME required 
another reboot after first Pnp Detection to be take in account 
in Smartcard Resource manager.


We strongly suggest installing always the new install kits with
the Gemplus SmartDiag tools.  To avoid conflict with older version
on installation of smartdiag.

During uninstall operation the Add/Remove program panel may freeze. But the
system still working. This default has been detected on some Chinese and Japanese
operating system.

Some empty repertories can still be present after the desinstallation. 

10. Installing execution trace and Return code


The Setup.exe executions always send trace to file in Windows temp directory.

To visualize trace execution, see under %Windows%\Temp\Gem_Setupxxxx.txt.
if many time the setup.exe is run, trace will append on existing file.
Note: be sure you have a Windows\Temp directory exist.

Standard execution: 

Sample of execution of complete Integrator installation package:

15:32:53_337: ########################################
15:32:53_347: ----  Gemplus Setup.exe  Trace Log  ----
15:32:53_347: Setup.exe Version: 3, 12, 0, 0
15:32:53_347: ARG=
15:32:53_367:  Silent Mode : 0
15:32:53_367:  UnInstall : 0
15:32:53_367:  DisplayAddRemove CommandLine : 1
15:32:53_367:  InstallPath Specify : 
15:32:53_367:  (*) Add Program Group : *
15:32:53_367:  LoadLibrary: Resources.dll
15:32:53_387:  GetInstallationd DLLs
15:32:53_437:  Install dll : GemPC400Installer.dll		Version: 3, 13, 0, 0
15:32:53_467:  Install dll : GemPC410Installer.dll		Version: 3, 13, 0, 0
15:32:53_507:  Install dll : GemPC413Installer.dll		Version: 3, 13, 0, 0
15:32:53_537:  Install dll : GemPC430Installer.dll		Version: 3, 13, 0, 0
15:32:53_667:  Install dll : GemPC433Installer.dll		Version: 3, 13, 0, 0
15:32:53_778:  Install dll : GemPCCardInstaller.dll		Version: 3, 13, 0, 0
15:32:53_828:  Install dll : GemPCKeyInstaller.dll		Version: 3, 13, 0, 0
15:32:53_858:  Install dll : GemPCSerialInstaller.dll		Version: 3, 13, 0, 0
15:32:53_898:  Install dll : GemPCUSBInstaller.dll		Version: 3, 13, 0, 0
15:32:53_918:  Install dll : GetStartedInstaller.dll		Version: 3, 12, 0, 0
15:32:53_928:  Install dll : MFC42.DLL		Version: 6.00.8665.0
15:32:53_968:  Install dll : MSUpdatesInstaller.dll		Version: 3, 12, 0, 0
15:32:53_988:  Install dll : Resources.dll		Version: 3, 12, 0, 0
15:32:54_028:  Install dll : SmartDiagInstaller.dll		Version: 3, 12, 0, 0
...

15:34:21_610:  CleanUp resource
15:34:21_610: Setup.exe completed  RC=0
15:34:21_610: ########################################

Exit code:
The Setup.exe return code could be use by the caller application.
Refer to the ExitCodes.h in the document files to get accurate
error code definition.


- END OF README.TXT -
